home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d16 / winutil3.arc / WINQUOTE.ARC / QUOTE.TXT < prev   
Text File  |  1990-11-01  |  6KB  |  137 lines
  1.                      QUOTE FOR THE DAY, FOR WINDOWS
  2.                             Version 1.0
  3.                       (c) Thomas Tuerke, 1990
  4.   
  5.                  "Proverbs are mental gems gathered
  6.                in the diamond districts of the mind."
  7.                                      - W. R. Alger
  8.  
  9.  
  10.  
  11. FOREWARD
  12. --------
  13. This little Windows 3 app will display one of many quotes that it keeps 
  14. on file.  It chooses one randomly when it is first invoked, and can 
  15. subsequently choose another at regular intervals.  The default is to 
  16. choose one every twenty-four hours, for those of you who keep your 
  17. machine on continually.
  18.  
  19.  
  20.  
  21. FILES
  22. -----
  23. Quotes are kept in a file normally called QUOTE.DAT.  The file must be
  24. in the Windows directory, or mentioned in the WIN.INI file; (more on
  25. that below.)  The file is simply a text file, containing one quote per
  26. line.  The text is 'formatted' when it is read in, making quotation
  27. marks and apostrophes more attractive (instead of those aweful minute
  28. and second ticks), as well as providing the ability to place line-breaks
  29. wherever you want them.  The format is one that I use in other programs,
  30. so for consistency I kept it the same here.  Consequently, the string
  31. is interpreted from OEM to ANSI when read in; if you use foreign marks,
  32. use the IBM version (Alt-132 for 'a' with an umlaut, for example) rather
  33. than the Windows character set.  
  34.  
  35. The rather nice side effect of this, though, is that any PC text editor 
  36. or word processor that can save text files (PC-8 bit, with CR/LF end-of-
  37. lines, specifically) can be used to create your own file of quotes.  
  38. Currently, restrictions are placed on the size of the file (128K) and the 
  39. length of the quote (1024 bytes).  Finally, placing an acknowledgment
  40. to the author can be done by separating the quotation (which I like to 
  41. enclose in quotes) with the three characters space-dash-space.  For 
  42. example,
  43.  
  44.       "I think, therefore I am." - Descartes
  45.       "Cogito cogito, ergo cogito sum: I think that I think, therefore
  46.        I think that I am." - Ambrose Bierce
  47.  
  48. (That's two quotes up there; pretend that the second had a case of word-
  49. wrap.)  The result of this is that the main body of the quotation will
  50. be displayed in a large face, while the author's name will appear in
  51. a smaller face, and right justified.  If you omit the three character
  52. sequence, everything will be displayed large.  Similarly, if you wish
  53. to place a dash in the quotation, I suggest you use '--' with no spaces
  54. on either side.
  55.  
  56. QUOTE will look for the name of the file in WIN.INI first.  It's section
  57. name is called [Gravesend Quotes], and it looks for the label QuoteFile=
  58. Full path and filename are allowed.  If that is missing, it will look for
  59. the file QUOTE.DAT in the Windows directory; if it still can't find
  60. anything, it will tell you to insert the mention into WIN.INI.
  61.  
  62.  
  63.  
  64. FEATURES
  65. --------
  66. If you want to have the quote refreshed periodically, you may also put
  67. the line "Minutes=" followed by some number, representing the number of
  68. minutes until another quote is picked.  Minutes=60 will pick a new quote
  69. every hour; Minutes=1, once a minute.  Minutes=0 will refresh the quote
  70. every five seconds; I used this for endurance testing, but you may like
  71. to have a new quote that often.  If this line is omitted, Quote will wait 
  72. 24 hours before picking another one.
  73.  
  74. I envisioned that Quote would be put in the load= list of files to load
  75. upon bootup; therefore, it will never launch in a minimized state.  If
  76. it's first in the list, you can ponder the profound thought each morning
  77. (?) while the rest of the environment loads.  Double-clicking in the 
  78. window (while the cursor is a bubble caption) will minimize Quote to 
  79. take it out of the way.
  80.  
  81.  
  82.  
  83. FORMATTING FOOTNOTES
  84. --------------------
  85. The logic that formats the quotes and apostrophes causes double
  86. quote characters to be alternately open and closed sexed quotes, so "Hi"
  87. will appear as ``Hi'' upon the screen.  Nesting double quotes isn't
  88. possible; you'll have to manufacture immitation double-quotes by using
  89. the ` and ' characters:  "He said ``hi'' (or ''hi'') to Sue.", but for 
  90. the most part, you probably wouldn't want to put double quotes within 
  91. double quotes anyway.  Double-quote characters appearing immediately 
  92. after a digit remain double-ticks.
  93.  
  94. Apostrophes are a little more involved.  Apostrophes that appear 
  95. immediately before spaces are converted to opening single quotes.  
  96. Those that follow non-numeric characters are converted to closing single
  97. quotes (this is adequate for uses of apostrophes like O'doule, it's, 
  98. as well as closing quotes.)  Apostrophes appearing after digits remain
  99. single ticks.
  100.  
  101. In-line breaks are provided by the vertical bar character.  For example,
  102. "This is on line one | And this is on line two" causes that string
  103. to be broken onto two lines.
  104.  
  105.  
  106.  
  107. FUTURE FEATURES
  108. ---------------
  109. I am considering adding dialog support, so that you won't have to
  110. manually set values by means of WIN.INI, as well as a handful of
  111. other little touches, like being able to copy the quote into the
  112. clipboard, and searching through the file for a specific word.  
  113. But right now it's a nice little gem that's barely a dozen K out on 
  114. disk, and not all that much in memory.  If there's something that 
  115. you'd like to see, get in touch with me
  116.  
  117.  
  118.  
  119. FINALLY
  120. -------
  121. If you like Quote, use it in good health.  If you would like to,
  122. feel free to add to or remove quotes from your copy of the file.  
  123. If you like it enough to pass it on to your friends, thank you;
  124. all I ask, though, is that you do the contents of the program 
  125. itself, this documentation, and the quote file intact.  If you
  126. like the app enough to send a monetary thanks, feel free to send
  127. a check to the following address:
  128.  
  129. Thomas Tuerke
  130. 441 San Carlos Way,
  131. Novato, CA 94945
  132.  
  133. Gravesend BBS is also a good way (the best way, actually) to get 
  134. a hold of me; the number is 707-795-4939, up to 2400 baud supported 
  135. (so far).  Other avenues are on UUCP as jandel!tmt@uunet.uu.net, 
  136. and on CIS at 76370,1674.
  137.